package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.smart.community.work.entity.ScheduleChangeRel;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 调班申请关联Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD方法
 * - 方法命名：使用动词+名词形式，语义明确
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的返回类型，避免使用Object
 * - 完整注释：所有方法都有完整的JavaDoc注释
 * - 数据访问封装：Mapper层负责所有数据库操作
 * - SQL优化：编写高效的SQL语句
 * - 参数映射：正确使用MyBatis参数映射
 * - 结果映射：正确使用MyBatis结果映射
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface ScheduleChangeRelMapper extends BaseMapper<ScheduleChangeRel> {

    /**
     * 根据原排班ID查询调班申请
     * 
     * @param originalScheduleId 原排班ID
     * @return 调班申请列表
     */
    List<ScheduleChangeRel> selectByOriginalScheduleId(@Param("originalScheduleId") Long originalScheduleId);

    /**
     * 根据目标排班ID查询调班申请
     * 
     * @param targetScheduleId 目标排班ID
     * @return 调班申请列表
     */
    List<ScheduleChangeRel> selectByTargetScheduleId(@Param("targetScheduleId") Long targetScheduleId);

    /**
     * 根据申请人ID查询调班申请
     * 
     * @param applicantId 申请人ID
     * @param status 状态（可选）
     * @return 调班申请列表
     */
    List<ScheduleChangeRel> selectByApplicantId(@Param("applicantId") Long applicantId, @Param("status") Integer status);

    /**
     * 根据审批人ID查询调班申请
     * 
     * @param approverId 审批人ID
     * @param status 状态（可选）
     * @return 调班申请列表
     */
    List<ScheduleChangeRel> selectByApproverId(@Param("approverId") Long approverId, @Param("status") Integer status);

    /**
     * 查询待审批的调班申请
     * 
     * @param approverId 审批人ID（可选）
     * @return 待审批调班申请列表
     */
    List<ScheduleChangeRel> selectPendingApprovals(@Param("approverId") Long approverId);

    /**
     * 根据原排班ID和目标排班ID查询调班申请
     * 
     * @param originalScheduleId 原排班ID
     * @param targetScheduleId 目标排班ID
     * @return 调班申请
     */
    ScheduleChangeRel selectByOriginalAndTargetScheduleId(@Param("originalScheduleId") Long originalScheduleId,
                                                         @Param("targetScheduleId") Long targetScheduleId);

    /**
     * 更新调班申请状态
     * 
     * @param id 关联ID
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer updateStatus(@Param("id") Long id, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 审批调班申请
     * 
     * @param id 关联ID
     * @param status 状态
     * @param approverId 审批人ID
     * @param approveTime 审批时间
     * @param approveRemark 审批备注
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer approveChange(@Param("id") Long id,
                         @Param("status") Integer status,
                         @Param("approverId") Long approverId,
                         @Param("approveTime") LocalDateTime approveTime,
                         @Param("approveRemark") String approveRemark,
                         @Param("updateBy") Long updateBy);

    /**
     * 批量更新调班申请状态
     * 
     * @param ids 关联ID列表
     * @param status 状态
     * @param updateBy 更新人ID
     * @return 更新数量
     */
    Integer batchUpdateStatus(@Param("ids") List<Long> ids, @Param("status") Integer status, @Param("updateBy") Long updateBy);

    /**
     * 删除调班申请
     * 
     * @param id 关联ID
     * @return 删除数量
     */
    Integer deleteById(@Param("id") Long id);

    /**
     * 批量删除调班申请
     * 
     * @param ids 关联ID列表
     * @return 删除数量
     */
    Integer batchDelete(@Param("ids") List<Long> ids);

    /**
     * 根据原排班ID删除调班申请
     * 
     * @param originalScheduleId 原排班ID
     * @return 删除数量
     */
    Integer deleteByOriginalScheduleId(@Param("originalScheduleId") Long originalScheduleId);

    /**
     * 根据目标排班ID删除调班申请
     * 
     * @param targetScheduleId 目标排班ID
     * @return 删除数量
     */
    Integer deleteByTargetScheduleId(@Param("targetScheduleId") Long targetScheduleId);
}
